Port SERVICEACCESS - SERVICE¶
Port to actively support Ethernet services based on a LwIP-based network stack
Stimulation¶
此端口不具备激励能力。
Properties 🛈¶
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
TCP/IP stack |
LwIP + Vector XL API |
[LwIP + Vector XL API] |
string |
此选项仅供参考,无法更改。 |
|
物理层 ❲网络访问❳ |
|||||
Port |
string |
Name of the port inside a network. In Vector Hardware Config, the network-based mode must be activated. |
|||
Automatic data reception on test run |
☑ |
bool |
Only operative if on the left for ‘Start’ either ‘Always’ is chosen, or ‘If necessary’ and the port is in use in the test configuration. |
||
MAC 地址 ❲客户端❳ |
‘02:00:4C:4F:4F:50’ |
string |
字符串(格式:02:00:4C:4F:4F:50),如果要使用默认 MAC 地址,则为 ‘default’ |
||
VLAN Settings ❲IEEE 802.1Q❳ |
TCP/IP stack is LwIP |
||||
VLAN mode |
TCP/IP stack is LwIP |
auto |
[auto, disable, single tagging] |
string |
如果应使用数据库中的 VLAN ID,则设为 ‘auto’;如果不应使用 VLAN,则设为 ‘disable’;如果应指定固定的 VLAN ID,则设为 ‘single tagging’ |
VLAN id |
TCP/IP 协议栈为 LwIP » VLAN 模式:‘single tagging’ |
0 |
int |
如果传入的数据包带有 VLAN 标签,则会对其进行过滤,只有带有该 VLAN ID 的数据包才能通过。不带任何 VLAN 标签的传入数据包也会通过过滤器。 |
|
IP Settings |
When no Consumer is chosen in Service Mapping and the mapping is used in a read test step, the settings here are used as a fallback. |
||||
IP version |
IPv4 |
[IPv4, IPv6] |
string |
所用 IP 版本的选择 |
|
Fallback IP address ❲client❳ |
TCP/IP stack is LwIP |
string |
用作客户端的 IP 地址。它必须与被测设备的 IP 地址位于同一子网,且不得等于其他参与者的 IP 地址,也不得等于操作系统分配给所选网络接口的 IP 地址。 |
||
Subnet mask / prefix length |
TCP/IP stack is LwIP |
‘default’ |
string |
For IPv4 addresses a subnet mask or prefix length can be given (format: ‘255.255.255.0’ or ‘24’). ‘default’ uses the default subnet mask of the network class of Fallback IP address (client). 对于 IPv6,只接受前缀长度,且不支持值 ‘default’。 |
|
网关地址 |
TCP/IP stack is LwIP |
string |
网关的 IP 地址,通过该网关可以访问本地子网之外的主机。如果不需要网关,请留空 |
||
Fallback TCP/UDP Settings |
When no Consumer is chosen in Service Mapping and the mapping is used in a read test step, the settings here are used as a fallback. |
||||
Source port range |
‘default’ |
string |
用于建立连接的本地端口范围。 值 ‘default’ 将选择随机端口。 Example: 123,456-567,789 |
||
SOME/IP Settings |
|||||
SD Multicast IP |
‘auto’ |
string |
Multicast IP address to be used for Service Discovery. Set it to ‘auto’ if the value from the database should be used |
||
SD Port |
‘auto’ |
string |
UDP port to be used for Service Discovery. Set it to ‘auto’ if the value from the database should be used. |
||
Behavior in case of protocol errors |
‘NotPresent’ |
[‘ERROR’, ‘NotPresent’] |
string |
Behavior of the test step when a protocol error occurs (e.g. the control unit does not respond). By default ‘NotPresent’ is returned. Alternatively, the test step can be evaluated with ‘ERROR’. |
|
Start Service Discovery automatically |
☑ |
bool |
Service discovery starts automatically. Otherwise it must be started manually by calling the StartServiceDiscovery job |
||
自动 E2E 计算的占位符值 |
int |
When this value is specified for an E2E element (e.g. CRC), upon transmission (in the test case or in the RBS) ecu.test automatically replaces it with the correct calculated value. The purpose of this option is to allow transmission of arbitrary fixed values (unequal to the value chosen here). Leaving this option empty completely disables the feature. For more information see the documentation at Tool categories - Automatic E2E calculation |
|||
Simulated Services |
TCP/IP stack is LwIP |
||||
MAC address ❲server❳ |
TCP/IP stack is LwIP |
‘02:00:4C:4F:4F:40’ |
string |
String (Format: 02:00:4C:4F:4F:40), must be different from the client address |
|
Leave simulated services active |
TCP/IP stack is LwIP |
☐ |
bool |
Leave simulated services active until the configuration is stopped, rather than just until the test case ends. |
|
Simulated router |
TCP/IP stack is LwIP » IP version: ‘IPv6’ |
☐ |
bool |
Simulates an IPv6 router. This fools the real SuT into thinking that the simulated ECUs are on a different subnet. Behavior details: The simulated router responds to Neighbor Solicitations (NS) with a Neighbor Advertisement (NA). The link layer address (MAC) used in the NA depends on the destination address of the NS. If the NA contains the clientIP or the routerIP as the destination address, the client MAC is used. If the destination address contains an IP from the active simulated services, the server MAC is used in response. Unknown destination addresses are ignored. |
|
IP address ❲router❳ |
TCP/IP stack is LwIP » IP version: ‘IPv6’ » Simulated router: ‘True’ |
string |
IP address of the simulated router |
Jobs 🛈¶
GetActiveServices¶
Returns a list of tuples (service id, instance id) for all active services. Only service IDs that are used in the test case or signal recording are returned.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
string |
List of tuples (Service-Id, Instance-Id) |
GetSubscriptionState¶
返回某个服务的事件组是否至少存在一个订阅。仅适用于 test step ‘Send Event (cyclic)’,不适用于基于脚本的服务仿真。
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
eventgroupId |
int |
Id of the event group |
|||
instanceId |
int |
Id of the instance |
|||
serviceId |
int |
Id of the service |
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True if at least one subscription is active |
StartReceiving¶
Manually starts the reception of network packets
StartServiceDiscovery¶
Starts Service Discovery if it is not already running.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True if Service Discovery was started |
StartSomeIpManipulation¶
Starts a SOME/IP manipulation (s. SOME/IP manipulation).
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Manipulator |
object |
A ByteStream or user-defined manipulation object that is dynamically applied to SOME/IP packets to be sent (s. SOME/IP manipulation). |
StartSomeIpSdManipulation¶
Starts a SOME/IP-SD manipulation (s. SOME/IP-SD manipulation).
Parameterization
Parameter
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
Manipulator |
object |
A ByteStream or user-defined manipulation object that is dynamically applied to SOME/IP SD packets to be sent (s. SOME/IP-SD-Manipulation). |
StopServiceDiscovery¶
Stops the service discovery, if it is already running.
Parameterization
返回值
Name |
在以下情况下可用 |
默认值 |
有效值 |
Type |
Description |
|---|---|---|---|---|---|
result |
[False, True] |
bool |
True, if the service discovery has been stopped |
StopSomeIpManipulation¶
Stops the SOME/IP manipulation (s. SOME/IP manipulation).
StopSomeIpSdManipulation¶
Stops SOME/IP-SD manipulation (s. SOME/IP-SD manipulation).